Administrator Guide 2017
Item Type - Drawing location
From Add Item in Template Maintenance select the Drawing location button shown here.

From Add Item in Template Maintenance select the Drawing location button shown here.

Drawing location allows annotation or marking of a drawing.

A typical use of this is where a location has a set of drawings or plans associated with it (eg. floor plans for a hospital).

The drawing can be annotated or marked up and sent back to the server as part of the completed form.  This means that a real-time, composite, marked-up drawing has been created and is displayed with interactive markers within individual reports.

It is also possible to create measurements from annotations by callibrating the original scale of the drawing with the pixels on the display.

Unable to show how a Drawing location item might look on a device.

Unable to show how a Drawing location item might look on a device.

Main

Main screen for creating/amending a Drawing location item.  Not all questions appear on all implementations.
Main screen for creating/amending a Drawing location item

Main screen for creating/amending a Drawing location item

Question This is the text “label” that is specifying the information that needs to be entered or the question to be answered. Although this is not necessarily a question in all cases, Question is used as the general term to cover the text shown next to an input field. The text should be as short as possible whilst still being self-explanatory. Over-long questions take up a lot of space on PDA screens with their restricted size, so try and make them concise. This text should be an aid to help guide the user through the screen. Any more explanatory text can be made available as “Auditor’s notes” or “Full question text”.
Mandatory

Tick this box if the question is mandatory and leave it blank if it is optional.  This will depend on whether the answer to this question is critical to the data that is being collected, such as signature to confirm customer acceptance.

Pen width

Early pen widths were a very thin 1px, but devices now default with 3px which can be modified here.

Pen colour

This sets the default colour for this tool.  To change from magic5's suggestion, click the 'change colour' link to select a new one. 

Set fixed width of box in pixels (0 = no fixed width)

Enter the width of the drawing location area in pixels. This may require some trial and error to achieve the optimum result for the device in use.

Maximum width of box in pixels (0 = no maximum)

Enter the width of the drawing location area in pixels. This will restrict modification of the device operator to prevent a drawing becoming ambiguous.

Display

Options for display in the office portal

            

Image Title

Image Title

Show expanded on results pages Tick this box to show drawings in the office portal
Show annotations rather than marker Show words rather than marker in the office portal

Advanced

Advanced features of a Drawing location item.
Advanced features that can be applied to a Drawing location item.

Advanced features that can be applied to a Drawing location item.

'Unique name' of item containing the drawing to use Enter the unique name of the drop-down list from which the image/drawing to be annotated will be selected.  This list in question must have a list attribute of 'associated image or document' and each list entry needs the image/drawing attached.
Auditor's notes

If you wish to offer the end-user guidance and direction on how to answer a question then use the Auditor’s notes field. This allows you to input any necessary text expanding on the basic question. For the end-user, the auditor’s notes are available via the “right click” option on the device – tap and hold the stylus on the question text.

Full question (for report)

The question text mentioned above should be framed in such a way as to indicate to the user the information that needs to be input. However, when this information is output on a report via the web site or a PDF additional wording may well be required. Use this field to phrase the original question in a way suitable for the report.

Cross reference

This field is output on reports to cross-reference the information with any relevant legislation etc.

Don't keep previous result when part of a document lifecycle             

Tick this box if you DO NOT wish data to be collected in this template item to be copied to any jobs created directly from the original form.  This is useful for a repeated task (such as booking in/out a rental item or repeated delivery) where the data remains the same but a sign-off is required so this box may be ticked for Date, Surname and Signature.  Please note that if a transformation option is applied to the newly created job, this setting may be over-ruled.

Item flag

Template item flags are used to apply display classes to template item in a consistent and efficient way.  They are set up in a system list called Template item flags and might be given names such as Danger so the text appears in red, Disclaimer for smaller text, Long answer to give extra space to the answer.  This means that changing the display class can be done in one place rather than on all template items.

*Unique name

A unique name must exist for everything in a magic5 template.  It is so important that magic5 pre-fills the prompt with a non-meaningful name which it will use by default.  This does not need to be changed.

However, if the data associated with the unique name is to be used elsewhere (for example as part of a calculation, imported or exported, or carried over to a new job), it is helpful to use a meaningful name (such as RefNo, QuantityOrdered, ItemTotal, ContactName, ReasonForReferral) and this meaningful name must be entered before the template is used with real data.

If the unique name is changed at a later date, existing data will not be lost but it may no longer be accessible by magic5, in which case it cannot be displayed, used in calculations or exported.  It is therefore recommended that this is done only as a last resort and that the original template is duplicated before changes are made - this means that existing data can still be retrieved if necessary.  If in any doubt, please contact magic5 support for the best way to deal with this.

Straight line tool

Straight line tool parameters for marking the drawing are selected here. 
Tools that can be applied to a Drawing location item.

Tools that can be applied to a Drawing location item.

Enable straight line tool Tick this box to make the straight line tool available to the device user.  This will connect a single point with another single point.  There will be a single measurement associated with this tool.
Default pen width (pixels)

This is the pen width that should usually be used on this drawing.  The magic5 default is 5 pixels.

Minimum pen width

Enter the smallest pen width (in pixels) that is to be used on this drawing location.  The magic5 minimum is 1 pixel.

Maximum pen width

Enter the widest pen size that is acceptable on this drawing location in pixels.

Pen colour

This sets the default colour for this tool.  To change from magic5's suggestion, click the 'change colour' link to select a new one. 

Pen colour palette list

Select a palette from the drop-down list to enable the device user to change the default colour selected above.  This palette must have been created as a list with an attribute of 'colour'.  It can be populated/changed without needing to refresh it here.

Prompt for length

Tick this box if the device user needs to enter a length for items in this tool.  A length will be requested each time a node is created (ie each tap on the screen).

Spider tool

Spider tool parameters for marking the drawing are selected here.
Tools that can be applied to a Drawing location item.

Tools that can be applied to a Drawing location item.

Enable spider tool Tick this box to make the spider tool available to the device user.  This will connect a single point with a number of other points.  Numerous measurements will be associated with this tool - 1 for each 'leg' of the spider.
Default pen width (pixels)

This is the pen width that should usually be used on this drawing.  The magic5 default is 5 pixels.

Minimum pen width

Enter the smallest pen width (in pixels) that is to be used on this drawing location.  The magic5 minimum is 1 pixel.

Maximum pen width

Enter the widest pen size that is acceptable on this drawing location in pixels.

Pen colour

This sets the default colour for this tool.  To change from magic5's suggestion, click the 'change colour' link to select a new one. 

Pen colour palette list

Select a palette from the drop-down list to enable the device user to change the default colour selected above.  This palette must have been created as a list with an attribute of 'colour'.  It can be populated/changed without needing to refresh it here.

Prompt for length

Tick this box if the device user needs to enter a length for items in this tool.  A length will be requested each time a node is created (ie each tap on the screen).

Chain tool

Chain tool parameters for marking the drawing are selected here.
Tools that can be applied to a Drawing location item.

Tools that can be applied to a Drawing location item.

Enable chain tool Tick this box to make the chain tool available to the device user.  This will connect a sequence of single points.
Default pen width (pixels)

This is the pen width that should usually be used on this drawing.  The magic5 default is 5 pixels.

Minimum pen width

Enter the smallest pen width (in pixels) that is to be used on this drawing location.  The magic5 minimum is 1 pixel.

Maximum pen width

Enter the widest pen size that is acceptable on this drawing location in pixels.

Pen colour

This sets the default colour for this tool.  To change from magic5's suggestion, click the 'change colour' link to select a new one. 

Pen colour palette list

Select a palette from the drop-down list to enable the device user to change the default colour selected above.  This palette must have been created as a list with an attribute of 'colour'.  It can be populated/changed without needing to refresh it here.

Prompt for length

Tick this box if the device user needs to enter a length for items in this tool.  A length will be requested each time a node is created (ie each tap on the screen).

Icon box tool

Icon box tool identifies which icons (if any) will be available for the device user to put on their drawing. 
Tools that can be applied to a Drawing location item.

Tools that can be applied to a Drawing location item.

Enable icon placement Tick this box to make icon placement available to the device user.  This will enable icons (such as riser indicators, power points) to be positioned with a single tap of the screen.
Icon list Select the list containing the icon images to be used.  This will need to have been set up as a list with attribute of Associated Image and the appropriate images uploaded for each entry - see Create list for more details.

Free pen tool

Free pen tool parameters for marking the drawing are selected here.

            

Image Title

Image Title

Enable free pen tool Tick this box to make the spider tool available to the device user.  This will connect a single point with a number of other points.  Numerous measurements will be associated with this tool - 1 for each 'leg' of the spider.
Default pen width (pixels)

This is the pen width that should usually be used on this drawing.  The magic5 default is 5 pixels.

Minimum pen width

Enter the smallest pen width (in pixels) that is to be used on this drawing location.  The magic5 minimum is 1 pixel.

Maximum pen width

Enter the widest pen size that is acceptable on this drawing location in pixels.

Pen colour

This sets the default colour for this tool.  To change from magic5's suggestion, click the 'change colour' link to select a new one. 

Pen colour palette list

Select a palette from the drop-down list to enable the device user to change the default colour selected above.  This palette must have been created as a list with an attribute of 'colour'.  It can be populated/changed without needing to refresh it here.

Display conditions (advanced)

Display conditions for a template item.
Display conditions that can be applied to a template item.

Display conditions that can be applied to a template item.

Only show when the following condition is true (1)-(4) Enter a conditional statement that affects whether the input item is displayed on the device such as whether a previous answer has been yes or no.
For more help on using Display Conditions view the how-to guide.
Record results when section isn't displayed Tick this box if you wish results to be recorded when section isn't displayed.